LGF_UnixTimeToDTL (FC / 3.0.1)

Overview

Author: Siemens Digital Industry

Short description

This function converts the Unix time of data type DInt to a date and time of data type DTL. The timestamp is calculated in UTC. This means that the time zone is not considered.

Only times after 01/01/1990 are permitted.

Block Interface

LGF_UnixTimeToDTL (FC)
DInt  timeUnix Ret_Val  DTL
    
   error  Bool
    
   status  Word
    
   

Input parameter

IdentifierData type Description
timeUnixDInt UNIX time to convert

Output parameter

IdentifierData type Description
Ret_ValDTL Converted time (Date and time).
In case of Error: 0 (error = true)
errorBool FALSE: No error
TRUE: An error occurred during the execution of the FB
statusWord 16#0000-16#7FFF: Status of the FB
16#8000-16#FFFF: Error identification (see following Table)

Status & Error codes

Code / ValueIdentifier / Description
16#0000STATUS_NO_ERRROR
Status: Execution finished without errors
16#6001WARN_CONVERSION_LIMIT
Warning: UNIX time (timeUnix) is exactly at the lower limit of 01.01.1990.
16#8000ERR_TIME_BEFORE_1990
Error: UNIX time (timeUnix) is before 01/01/1990. The function does not support this conversion.

Change log

Version & DateChange description
1.0.0Siemens Industry Online Support
16.10.2018First released version
1.0.1Simatic Systems Support
18.06.2019Standard header and block parameters update, status parameter added
1.0.2Simatic Systems Support
10.07.2019Commends added and code intention adjusted
Add ENO handling
3.0.0Simatic Systems Support
23.04.2020Set version to V3.0.0
Harmonize the version of the whole library
3.0.1Simatic Systems Support
23.02.2021Insert documentation